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Appie II Bugbyter Quick Guide 


Bugbyter Command Level 
General Commands 
.doscommand Execute DOS command. Press 
to return to Bugbyter. 
© ú Quit Bugbyter (exits through DOS 
f vector $300). 
(mM) Enter Monitor. Return to 


Bugbyter with 
(ConTROL}-(¥). 
address Disassemble object code 
beginning at address. 
Continue disassembling object 
code. 
SET Customize Bugbyter’s Master 
Display, where: 


© Moves window 
down. 

(cs) Moves window-up. 

Fixes subdisplay and 
advances to next 


subdisplay. 

ON Turn Bugbyter’s Master Display. 

OFF ten Bugbyter's Master Display 

Ww Bi soayright and version 
number. 


(Brun Bug biter ) 


Command-Line Editing 

Keystroke Editing Function 

RETURN Accept user-entered command 
line. 

cs) Move cursor to the left. 

(=) Move cursor to the right. 


Move cursor to beginning of 
command line. 

Accept next keystroke verbatim. 
CONTROL)-(D)] Delete a character. ” x 
(CONTROL) (1) Enter insert-character mode {any 
other function key exits from this 





mode). i 
CONTROL)-(N) Move cursor to end of command 
* line. 3 5 


CONTROL)-(X) Delete command line. 


ioral 





Joint 
ue. 


eld. 
axt 


line. 


int 


les 


afore 


res 


point 


bles 
sed 


Debugging in Execution Mode 





From the Bugbyter command level, you can enter 
Execution mode by typing one of the following 
commands: 


addressG Enter Execution mode, executing 
code as a subroutine starting at 
address. 

© Execute code as subroutine, 
continuing from previous address. 
An RTS opcode returns to 
Bugbyter. 

Enter Execution mode, jumping to 
code at address. 

© Enter Execution mode, continuing 

trom previous address. 


address) 








User Soft Switches 
Location Soft Switch Function 
start+3 Execute undefined 6502 


start+4 


start+5 


start+6 


start+7 
start+8,+9 
start+$A,+$B 
start+$C,+$D 


CALL 1016 


CALL 8192 


opcodes ($80 = on; 0=off— 
default). 

Use hand control button 0 to 
suspend Trace ($80=on; 
0=off—default). 

Use hand control 0 for Trace 
Rate ($80 = on—default; 
O=off). 

Disable keyboard polling in 
Trace, Single-Step modes 
(MSB on + ASCII character 
code for escape character, 
MSB off= normal polling— 


default). 

Sound ($80 =on—default; 
0=off). 

Cycle Counter value (low-byte, 
high-byte). 


Starting address of real-time 
code (default = $FFFF). 
Ending address of real-time 
code (default = $FFFF). 
Restart Bugbyter using the 
Monitor's 
(CONTROL)-(Y ) vector. rae 
Restart Bugbyter using 
Bugbyter's specific load i. 
address. ii 


> 





e 
I 


tion 
antered command 


to the left. 

to the right. 

19 beginning of 

ve. 

eystroke verbatim. 
acter. 

haracter mode (any 
n key exits from this 


2 end of command 


nd line. 


Memory Reference 
Ve MEM 


Edit memory subdisplay where: 


as hex and ASCII, or 
(P) Display contents of 
address and address + 1 
as pointer. 
address Enter hex address of 
memory to display. 
(=) Advance to next cell. 
or 
or (RETURN) » 
(=) Return to previous cell. 
ESCAPE) Return to Bugbyter 
command line. 





adcress:mnemonic Bugbyter assemblies 
mnemonic, placing 
opcode at address. 

Fill address with hex value. 

Fill address with ASCII 
character (MSB on). 

Fill address with ASCII 
character (MSB off). 

Multiple values and ASCII 
text (MSB on or off) can be 
mixed freely in memory fill. 
Type slash (/) to enter the 
next character verbatim. 


or address:value 
or address:'‘text’’ 


or address: 'text’ 


or (any mixture) 


Display next available 
address, allowing you to 
type any of the above 
commands. 

address: Enter Memory Page 


display; showing 

184 memory cells (starting 
at address) in hex and 
ASCIl. Press and 
then press to 
display next 184 cells. 
Press to return 
to Bugbyter command 
level and Master Display. 


+decimalvaiue= Convert positive decimal to 


hex. 

—decimalvalue= Convert negative decimal 
to hex (65536- 
decimalvalue). 

value= Convert hgx to decimal. 

$value= Convert hex to decimal. 


(H) Display contents of address \@ 


ve 


ve 


\e 





Register Reference 

PC =address Set 6502 Program Counter with 
hex address. 

A=value Set 6502 A-register with hex 
value. 

X=value Set 6502 X-register with hex 
value. 

Y=value Set 6502 Y-register with hex 
value. 

S=value Set 6502 Stack Pointer with hex 
value. 

P=value Set 6502 Processor Status 
register with hex value. 

C=value Set Bugbyter Cycle Counter to 
value. 

R= value Set Bugbyter keyboard Trace 


Rate to value. 


Trace/Single-Step Mode 


From Bugbyter's command level, you can enter 
Single-Step mode by typing: 


addressS Enter Single-Step mode and 
execute single opcode starting 
at address. 
© Enter Single-Step mode, 
continuing from previous 


address. 


From Bugbyter's command level, you can enter 
Trace mode by typing: 


addressT Enter Trace mode and interpret 
instructions starting at address. 
Enter Trace mode, continuing 


from previous address. 
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sonu Onc in Single-Step or Trace Mode (seeSor 
T commands above), you can enter any of the 
Rig following single-keystroke commands: 


wh Ae 


Single-step, executing next 
instruction only. 
Skip next instruction. 


ie f Enter Trace.mods ton continuous 





~ trace: då enee 


MTP PCF 


i "Trace. until RTS opcode 


eficountered. poset: 
Return to Bogbyter čoinmërd 





Sound of. 


~ Display primary ApipletPéereen: 


Display secondary Apple Ul f 
‘screen. 

Display Apple II Text screon, 

Display Apple |! Low-resolution 
graphics servers Ic 

Display Apple 4! High-resolution 
graphics scfögri. 

Display Full sereen graphics.: 

Display Mixed téxt-and graphics. 


From the Bugbyter command level, you can select 


one of the following options: 


O=A 
a2, z O=x 
4 omy. 

o=s 


O=P 


O=B 
O=E 
sas: 








rs 

Dispiay 6502 Accumulator in 
binary. 

Display 6502 X-register in binarys: 


“Display 6502 Y-register in binary. 


Display 6502 Stack Pointer in 
binary. 

Display 6502 Processor Status 
register in binary. 

Display instruction bytes in hex. 

_Display computed | éftactive á 

úda 


eme a TE 





sutrrg 


” Breakpoints 
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1" Alf breakpoints are set and clearad from the 
7#" T Buġbyter command level. 
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Set breakpoint “n” where: 





value |" Sets breakpoint 
> : ` feld to value. 
© Mos tor" 
n d Wes previous field. 


Jar et Moves to next 
field. 
(ESCAPE) or 7. Returns'to 
(RETURN i Bugbytar 
"> ecomimand line. 


estes 





e “POINT is deina CA Ereakpoint 
address. 

@ _ COUNT. is, the number of times 
” Bugbyter encountered the 
breakpoint address, 





break, TRIG must be gne or 
greater. 

BROKE isthe number of times 
Bugbyter triggered. 


Insert real breakpoints (BRK 
opcod (00)) into addresses 
spj Šreakpoint 
subdisplay. Disables breakpoint 
modification. 

Replace BRK opcodes with 
original instructions at 
addresses specified in 
breakpoint subdisplay. Enables 
breakpoint modification. Used 
for interpretive debugging 
(default). : 

Clear all breakpoints. 

Clear breakpoint “n”. 
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Editor Commands: A Functional Summary 


Editor and Assembler 
Quick Reference Card 


ron 


Edoran — 





Storing and Retrieving Files From a Disk 


Editor Command Form 


LOAD fname [,Ss] [,Dd] 
[Vv] 


APPEND [line#] fname 
[,Ss] (,Dd] [, Vv] 


SaVE [begin# [-end#]] 
[fname] [,Ss] [,Dd] (, Vv] 


CATalog [,Ss] [.Dd] [,Vv] 


FILE 


LENgth 


SLot slot# 
DRive drives 


Volume vol# 


Command Description 


Loads the file with 
fname into the text 
buffer, destroying 
anything already in 
the buffer, 

Appends all the lines of 
fname to the text 
buffer after [line#). 

Saves the lines [in the 
indicated range] to the 
file named fname. 

Displays the DOS 
catalog of the disk in 
the current SLot, 
DRive and Volume. 

Displays the current 
status of the Editor's 
filename, SLot, DRive, 
and Volume 
parameters along with 
the text buffer 
memory usage totals. 

Displays the current 
text buffer’s file usage 
totals. 

Sets the current disk 
SLot to slot#. 

Sets the current disk 
drive to driver. 

Sets the current 
volume number to 
vol#. 


Executing Direct DOS Commands 
Editor Command Form 


Command Description 


Issues the characters 
after the period to DOS 
3.3 to be processed as 
aDOS command. DOS 
checks the syntax and 
issues any required 
error messages 


NE 


Vi 
Lis 


Pri 





tiption 


al 
al 
to 
ptions 
sk 


Bit set 


bler 


listing 
al 


atable 


r times 

ring 

r size 

lines 
ing 


al 


Fi 


Ban 


Be, 


ine 

ys all lines within 
idicated range 
tontain the string. 
es All/Some of 
ccurrences of a 

| (oldstr) to a new 
| (newstr) within 
inge of lines 
ated. 

Edit mode for all 
indicated [that 
inthe string). 
es the Editor 
rand delimiter 
icter to the new 
cter indicated. 
dermits the colon 
cter to be used 
earch string. 


the currently- 
+ text buffer, 
3 the contents of 
irrent one for 
diting. 

the entire 
its of text buffer 
returns to single 
Jffer mode with 
affer 1. 


e Editor display 
es to 40-column 
ly mode. 

e Editor display 
es to 80-column 
y mode, if your 
Il can support 


s lowercase 

ster entry (only 
ple II or Apple II 
ystems that 

t otherwise 

e lowercase 
sters). 


(CONTROL)-(W) 


SET Lcase 


SET Ucase 


Tabs (Tablist] [.tabchar.] 


TRuncON 


TRuncOFf 


Leaving the Editor 
END 


MON 


Where lineg 


Disables lowercase 
character entry that 
was enabled by 
(CONTROL)-(E) 
command. 

Enables lowercase 
character entry (for 
Apple II or Apple II 
Plus systems that do 
not contain an ALS 
Smarterm Card, but 
can receive and 
display lowercase 
characters). 

Disables lowercase 
character entry that 
was enabled by the 
SET Lcase command. 

Sets the Editor display 
tabs stops to the 
Tablist and sets the 
tab character to 
tabchar. 

Turns on comment 
display truncation. 

Turns off comment 
display truncation. 


Ends the Editor session 
and returns control to 
the BASIC interpreter. 

Enters the Apple |! 
Monitor. (Type 
return to the Editor.) 

Displays the 
hexadecimal address 
of text for linet 
(address useful when 
using Monitor 
commands). 





Calling the Assembler 


PR# slot# [,DevCtristrg] 


ASM srcfile [, @ | objfile 
(Ss [,Dd [,Vv]]] 


Edit Mode Keystroke Summary 
Edit Mode Keystroke 





Editing Function 


Move cursor left one 
character 

Move cursor right one 
character 

Delete current character 

Insert characters at this 
position 

Replace a character 


Enter control character 
into text (Verbatim) 

Restore the original line 

Find the indicated 
character in the line 
and move the cursor 
there 

Store line as it appears 
on screen 

Truncate line after 
current cursor and 
store the remainder in 
text buffer 

Cancel Edit mode and 
return to command 
level 


Sets the Assembler 
output device to slot 
(slot#) and saves the 
DevCtristrg for device 
initialization by the 


Assembler. 


Calls the Assembler to 
assemble the source 
file (srcfile) and create 
an object file (objfile) 
on Slot s, Drive d, 


Volume v. 


aA 


CONTROL)-(0) 
CONTROL)-(1) 


any noncontrol 


character 


CONTROL }-' 


character 


(CONTROL)-(R) 


(CONTROL)-(F), any 


character 


(RETURN 
CONTROL )- 


CONTROL )-(X) 




















Mnemonic Instruction 
ADC A+M+C->A 

AND AandM->A 

ASL C <- [7.0] <-0 

BCC Branch on C = 0 

BCS Branch on C = 1 

BEQ Branch on Z = 1 

BGE Branch on C = 1 

BIT A and M, M7 -> N, M6 -> V 
BLT Branch on C = 0 

BMI Branch on N = 1 

BNE Branch on Z = 0 

BPL Branch on N = 0 

BRK Force Break 

BVC Branch on V = 0 

BVS Branch on V= 1 

CLC 0->C 

CLD 0->0 

CLI 0->I 

CLV 0->vV 

CMP A - M status -> P 

CPX X - M status -> P 

CPY Y - M status -> p 

DEC M-1->M 

DEX X-1->X 

DEY Y-1->Y 

EOR AXORM -> A 

INC M+1->M 

INX X+1->X 

INY Y +> y 

JMP Jump to New Location 
JSR Jump to Subroutine 
LDA M->A 

LOX M-> x 

LDY M->yY 

LSL C <-[7..0] <-0 

LSR 0 -> [7...0] -> C 

NOP No Operation (PC=PC+ 1) 
ORA MorA->A 

PHA A->Ms S-1->§ 
PHP P->Ms S-1->§ 
PLA S+1->S Ms->A 
PLP. S+1->S Ms->p 
ROL <= (7, 0<— dr 
ROR '—> C => [7.0] >77 
RTI Return from Interrupt 
RTS Return from Subroutine 
SBC A-M-C->A 


SEI 1-> I 
STA A->M 
STX X->M 
STY Y->M 
TAX A->X 
TAY A->Y 
TSX S->X 
TXA X->A 
TXS X->S 
TYA Y->A 
where 


6502 Assembly Language Summary 
Mnemonic Sum ry SEC 1->C 
. SED 1->D 


A, X, Y, S, and P are the 6502 registers 
M is a memory location 

C is the Carry bit of the P-register 

+ indicates binary addition 

[7...0] is a bit description of M or A 

Ms indicates the location to which the S- 


register points. 


Addressing Mode Summary 


Note that all required syntax may be preceded by 
an optional identifier in the label field of a 


statement. 


Addressing Mode 
Implied (no address) 
Accumulator 
Immediate 

Low 8 bits of address 

High 8 bits of address 
Zero page 

Indexed X è 

Indexed Y 
Absolute 

Indexed X 

Indexed Y 
Indexed, Indirect X 
indirect,indexed Y 
Absolute Indirect 


where 


Required Syntax 

ope 

opc A 

opc #expression 

opc #> expression 
Ope # <expression 
Ope zpg-expression 
opc zpg-expression,X 
opc zpg-expression,Y 
opc abs-expression 
opc abs-expression,X 
opc abs-expression,Y 
opc (zpg-expression,x) 
opc (zpg-expression),Y 
JMP (abs-expression) 


opc refers to an instruction mnemonic 
abs refers to an absolute address expression 
zpg refers toa zero-page address expression. 


All other characters must be typed as shown. 


Ts ~ 





IS- 


ad by 


n 

ion 

ion 
sion 
sion,X 
sion,Y 
sion 
sion,X 
sion,Y 
sion,X) 
sion),Y 
ssion) 


ression 


‘ession. 


Assembler Directive Summary 
Directive Syntax Format 


ASC string. 

CHN filename 
({slot]{,[drive][,vol]]] 

CHR /? 

DATE 

DCI . string. 


DDB expr{,expr...] 
DEF identifier 


DEND 
DFB expr{,expr...] 
DO expr 


DS expr[,expr] 
OSECT 


DW expr{,expr...] 
ELSE 


ENTRY identifier 
identifier EQU expr 


EXTRN identifier 


FAIL p,.string. 
FIN 


IBUFSIZ expr 


IDNUM 


Directive Description 


ASCII character data 

Chain to new source 
file 

Character used for 
REPeat 

DATE character 
data (9) 

special ASCII character 
data 

Define Double Byte 

Define absolute 
identifier 

Osect END 

DeFine Byte(s) 

DO assembly if 
expr > 0 

Define Storage [value] 

Dummy Section 
beginning 

Define Word(s) 

complement Assembly 
mode 

define ENTRY identifier 

EQUate identifier to 
expr 

Refer to external 
identifier 

FAlLure error message 

FINish conditional 
assembly 

Set INCLUDE-buffer 
size 

generate IDNUM data 
(6 bytes) 


Directive Syntax Format 


IFEQ expr IFGE expr 
iFGT expr 
IFNE expr IFLE expr 
IFLT expr 
INCLUDE filename 
({slot][,[drive}[, vol]]] 
LST [ON |OFF] 
L{NO]opt[,[NO]opt...]] 
MACLIB 
{slot]{,[drive][,vol}] 


< MSB [ON , OFF] 


OBJ expr 
ORG expr 


PAGE 
REF identifier 


REL 

REP expr 
SBTL string. 
SBUFSIZ expr 
SKP expr 

STR string. 
SW16 [expr] 
ZDEF identifier 


ZREF identifier or 
ZXTRN identifier 


Directive Description 


begin conditional 
assembly 

begin conditional 
assembly 

INCLUDE file into 
source 

Control listing options 


Macro library disk 
enable 

Most Significant Bit set 

OBJect memory 
address set 

Origin of Assembler 
adrs 

eject a PAGE on listing 

REFerence global 
identifier 

generate RELocatable 
output 

Repeat CHR expr times 

define subtitle string 

Set source-buffer size 

SKip expr blank lines 

counted ASCII string 
data 

call SWEET 16 
interpreter 

Zero-page global 
definition 

Zero-page external 
reference 





— 
mands 
nd Description 


ye characters 

® period to DOS 
e processed as 
ommand, DOS 
the syntax and 
ny required 
2ssages. 


Manipul ting Lines in the Text Buffer 
Ada flies] 


Insert lines 


COny linet 1 [-line#2] 
Tålinez3 


Delete begin# [-end#] z 


Røfplace begin# [-end#] 


NEW sie 


Adds lines [after lines] 
to the text buffer. 
Enters Input mode to 
add the new lines. 

Inserts lines from the 
keyboard before 
line#. Enters Input 
mode to insert the 
new lines. 

Copitis lise 7 {thru 
line#2j io betore 

‘Mine#3. 


o Deletes the range of 


fries from the butter. 


““Geletes the range of 
" Jines and enters Input 


_ Mode, like Insert, to 
add new lines to the 
text buffer in place of 
the deleted lines. 


` Deletes the entire 


contents of the text, 
buffer, 


Viewing Your Text inthe Text Buffer 


List [begins [-end#]] 


(CONTROL)-(A) 


Print [begins (-end#]] 


Displays, with line 
numbers,:the lines in 
the indicatad range 
within the text buffer, 
Control cheracters 
display in inverse 
video. 

Relists.the lines of text 
listed by the most 
recent. List command. 

Outputs, without line 
numbers, the lines 
within the indicated 
range. Control 
characters are output 
as control characters, 


Changing Text Within a Line 


Find (begins (-end:}] 
[.string.] 


Change [begin# [-end#]] 
-oldstr.newstring. 


Edit [begins [-ends]] 
[.string.] 


SET Delim .char. 


Editing Two Files at Once 


SWAP 


KILL2 


Displays all lines within 
the indicated range 
that contain the string. 

Changes All/Some of 
the occurrences of a 
String (oldstr) to a new 
string (newstr) within 
the range of lines 
indicated. 

Enters Edit mode for ail 

tines indicated [that 
contain the string). 

Chariges'the Editor 
command delimiter 
character to the new 
character indicated. 
This permits the colon 
character.to-be used 


wif a Search string. 


y 4 Rib ver gr 


Swape the currently- 
active text buffer, 
Saving the contents of 
the current one for 
later editing. 

Deletes the entire 
contents of text buffer 
2 and returns to single 
text buffer mode with 
text buffer 1. 


Altering the Display 


COLumn 40 


COLumn 80 


(CONTROL}-(E) 


Sets the Editor display 
routines to 40-column 
display mode. 

Sets the Editor display 
routines to 80-column 
dispiay mode, if your 
Apple II can support 
this. 

Enables lowercase 
character entry (only 
for Appie I! or Apple II 
Plus systems that 
cannot otherwise 
receive lowercase 
characters). 


SE 


SE 


Tat 


TRU 


TRu 


ENC 


MOF 


